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This edition of the newsletter will cover 
December and January as ae like to have a break at 
this time of year^ and this coEbined issue follou's 
the pattern of previous years. 

We are proud to announce that the National 
0S9 User Group is in receipt of an award for our 
efforts. The National CJS9 User Group has been 
honoured by the 'Coco-Link Award 1990'. Those of 
you who also support the Coco-Link ffiagaiine 
produced by Robbie Dalzell as editor and Garry 
Holder as sub-editor would already be aware of 
this award, as a copy of it was included ir. the 
December edition of Coco-Link. 

I Rust say that we were taken completeiy by 
surprise by this award and are ftost grateful for 
the recognition of our efforts to support 0S9 and 
the Color Computer, and of course very pleased to 
receive the $1(52. 00 cheque, payable to the 
National 0S9 Usergroup, which is part of the Coco- 
Link award. 

Our sincere thanks go to Robbie Daizell and 
Garry Holder for this unexpected but very welcome 
recognition, 
(It's always nice to receive a pat on the back,) 

The COCO-LINK MAGAZIhE is produced bi-monthly in 
South Australia and is well worth your support if 
you are interested in any aspects of the Tandy 
Color Ccffiputer. This magazine includes many 
interesting BASIC listings, hardware tips, general 
infori&ation, advertisements for hardware / 
software and even presents 0S9 articles. If you 
do not currently subscribe then contact:- 

CocD-Link Magazine 
31 Nedland Cres. 
Pt.Noarlunga Sth. S.A. 5167 

Phone (08) 386 1647 

SUBMISSIWS We are in urgent need of submissions 
for inclusion m this Australian 0S9 Newsletter. 
Our more advanced members seem to be mostly 
interested in 'C programmes whilst new users are 
often requesting Basic09 listings and prograiTimes. 
So how about it, every member must be able to 
submit something which is suitable for the public 



domain. Your submission does not have to be a 
masterpiece as we can all learn soniething from 
others at all skill levels. Maybe you have 
questions or a problem which someone in the 
usergroup will be able to solve. 

The Australian 0S9 Newsletter is intended to 
be a newsletter produced by the members of the 
National 0S9 Usergroup. That is you. ke simply 
collate all the information and present it here in 
the neuBletter. The intent also is that this 
service is provided on a non-profit basis, hence 
no paid advertisements are included and no charges 
apply to members for any submissions, including 
private ads. 

All submissions must be sent to us on DISK, 
preferably in 0S9 format and as a 'vanilla" ASCII 
file. We can however transfer "vanilla" ASCII 
files from RS-DOS and MS-DOS disks. 

IN THIS EDITION Bob Devries presents some 
valuable information on transferring 0S9 PROFILE 
files to SDF (Systeui Data Files) and also presents 
the advantages of using the GFX2 module which is 
available from our P.D. library. 

Don Berrie has included some insight for Multi-Vue 
users, and I have some comments about "SPANNER", a 
hard-disk backup and restore utility, also from 
the P.D. library. 



Unfortunately our P.D, database is not yet 
completed so we are still not able to fill 
requests for a copy of it on disk. Work is 
continuing on this and it will be completed early 
in the new year. 

We do hope that you have found something of 
interest in the newsletters presented during 1990 
and that the article which you are going to subinit 
will help other members enjoy their 0S9 even 
more. Remember to look for our ne>;t newsletter 
edition in February 1991. 

Cheers, Gordon. 

JERRY CHRISTMAS TO ALL 



Bob, Don, Jean-Pierre £- Gordon. 
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We publish the following docuBentation, together with the C source code with the kind peraiBBion of the 
author Jerry Stratton, one of the Bore active contributors to the INTERNET 0S9 sailing list. If you do 
not have the necessary C compiler to enable you to compile iti the compiled executable file is available 
froft our public doRiain library. The usual rules for copying apply. (You mill also need the Cgfx.l 
library replacementi together with the support header files in order to successfully compile it. This 
replaceaent library is also available in our PD library.) 

OPTSTART 

OptStart allows you to use the same script to do different things, without having to ask or wait. It 
takes one or two comibands, and then executes one of the conwriands depending on whether a specified key is 
being held down. 

For example, I have the following line in my startup script: 

optstart 'rdisk </d0/Yes' 'rriisk r* </l 

Optstart defaults to checking the SHIFT key. Sc*, in this case, the comntanri "rdisk </de/Yes* is executed 
if I am not holding down the shift key. This simply sets up my ramdisk. If I am holding down the shift 
key, it executes the command 'rdisk r". This attempts to rebuild whatever ramdisk existed before I 
rebooted, (this is the RamDisk available from MicroCom). 

You can use any of the following keys'. 

SHIFT 

CTRL 

ALT 

LEFT arrow 

Rim arrot! 

UP arrow 

DOWN arrow 

SPACE bar 

and these can be used in any combination. The following command: 

Optstart 'echo up' 'echo down' -shift -ctrl 
will echo the word "down' if both the shift and control keys are held down. Otherwise, it will echo 'up'. 

Optstart 'mega' -shift -ctrl -alt </l 

in your startup script will execute the 'mega' coRjmand (setting up 1 Meg) UNLESS you are holding down the 
SHIFT key, the CTRL key, and the ALT key. 

Note that the </l is required in scripts, which is where you'll probably be using OptStart most often. 

Jerry Stratton 
CRITSusdcsv. scusd. edu 



■CUT HERE 



/* Optstart [IfUp] IfDown [-optkey] (c) 1996 Jerry Stratton */ 

^include <stdic.h> 
^include <keysense.h> 

^define Stdin B 



December 1990 Page 3 



AUSTRALIAN 0S9 NEWSLETTER 



#define StdOut 1 
#define StdErr 2 

Biain (argciargv) 
int argc; 
char *argv[ 3; 



int KBys=B; 
char *DDum='\e"; 
char itUp="\B'; 

/* e>;it quietly if there are no arguffjent£ */ 
if (ar9c<2) 
Bxit(0}; 

I^ check for options and coMandE- */ 
while (—argc} { 

if (*argv[argc3=='-') 

Keys+=GetKey(argv[ argc 3+1) ; 
else if (*DDtfn) 

Up=argv[argc3; 
else 

Doidn=argv[argc3; 
} 

/> if no conditions were given^ e/:it quietly */ 
if UDown==0} 
exit(0}; 

/i^ if no options were given, assume shiftkey */ 
if (Keys==i3) 
Keys=SHIFTBIT? 

/* check if the Key(5) are doar! */ 
if ((Key5&_gs.ksn5(StdIn))==Key5} ( 

system (Down); 

ufaitO; 
) else if (*Up) I /* if an Up branch exists, do it */ 

systeni (Up); 

waitO; 
} 
} 

/* find out what key the option is */ 
(aetKey (Option) 
char *Option; 
( 

int Count=8; 
static struct ( 
char *OFtNanie; 
int Mask; 

} Opt£[]= {! "SHIFT", SHIFTBIT}, 
( 'CTRL', CTRLEITl, 
CALTNALTBITi, 
CUFSUPBIT), 
('D()WN',DOWNBITi, 
ClEFTMEFTBJTJ, 
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CRIGHT'iRimBITJ, 
{ 'SPACE', SPACEBIT}, 
('duBimy'i0)}i 



while (Count<5izeof(0pt5) 

H-Count; 
return (Opt5[ CrajTit 3. Mask) ; 



&& 5trucftp(0pt5[Count3.0ptNaB»e,0ptiDn)) 



0S9 Profile to SDF conversioB. 
Dy Bob Devries. 



Recently there has appeared a new 0S9 database 
prograMfie, namely Data-Windows, written by Keith 
Alphonso and sold by Alpha Software Technologies, 
The idea behind this database progranwue is quite 
good, in that is uses 0S9's windouiing capabilities 
to its fullest extent. Multiple windows may be set 
up to simultaneously display date and reports in 
different bays, and with different key fields. 

The prograffffffe is not tuithoijt its probiems and 
iTiinor bugs, howevei^. (me of these buglets is that 
it, like one of Mr. Alphonso's other prograntffies, 
'DMTree', it does not leave the aindow the way it 
found it when it quits. 

Another rather annoying problern is that the 
manual is written as if the user is expected to be 
an expert in both the use of databases, and indeed 
the prograffiiTie itself! Quite e few features are 
merely skiffrfBed over, and others are not fftentioned 
at all. A fiention is made of a file forg^at called 
DB9-9B, but nowhere is this file format explained. 
To find this information, you will be required to 
purchase extra software from the company. 

Without going into the trials and tribulations 
I went to to try and get a working database using 
the copy lent to me by one of our members for 
review purposes, I will get to the point of this 
article. 1 wanted to import a database froiij 0S9 
Profile! and, according to the Data-Windows 
manual, it is capable of importing data in SDF 
format, which is e file format that quite a feui 
other database programmes use for exporting files. 
Not so 0S9 Profile, however. It only outputs data 
in DynaCalc spreadsheet format. That's fine if you 
want to put data into your spreadsheets, but not 



much use for anything else. Nouf what my little C 
programme does is read the Dynacalc file format 
that Profile writes, and outputs an SDF format 
file. For those who are not familiar with SDF 
files, here's what they look like:- 

•field r, "field 2S /field n"<CR> 

this is record 1 

"field r, 'field 2', , 'field n'<CR> 

this is record 2 



And so on for all the records in the database 



file. 



So you see that fields within records are 
separated fay commas, and surrounded by inverted 
comntas, and records are separated by carraige 
returns. By the way, here I encountered what to me 
is a rather serious bug in 0S9 Profile, namely 
that you cannot create a spreadsheet file from a 
database that has anything other than text data 
fields (type 1). If you do. Profile crashes! Usage 
of the conversion programme, after you've created 
the spreadsheet file with Profile, is simple. Here 
it isi- 

Convprofile <dyna_file >sdf_file 

Note that both input and output redirection is 
used. So without further ado, here's the code for 
my little utility. 



/* Conversion programme to change 0S9 Profile spreadsheet file */ 
/^. to SDF file. Accepts 3TDIN for input, and writes STDOliT. */ 
ftdefine EUFMAX I0B0 



iT^ainO 

{ 



char *inbuffer; 
int nc = I; 
int flag = 0; 
char #ffialloc(); 



/* pointer to memory returned by mailocO */ 
/* integer counter preset to 1 for while loop */ 
/* end of record flag */ 
/* define function as returning char pointer */ 
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inbuffer = aalloc(BlRlAX); /* grab a chunk of nesiory to store file lines */ 
while (nc > 0) /* keep reading until nc = BJ (end of file reached) */ 
{ 

nc = readln(fi,inbuffer,BUFMAX); /* grab a line of text */ 
if((5trnci»p(Vro(i!', inbuffer, 4) ==0) II (strncffipf "/ROW, inbuffer, 4) =0)) 

continue; /* ignore special codes for DynaCalc */ 
ifUnbufferEB] == '*M /* and coffinjent lines */ 

continue; 
ifUinbuffer[03 = 'SM && (inbufferClJ == '\nM) 
( 

uriteU,*\nM); /* if 3 is found, end of record is reached */ 
flag = 0; /* so print a carraige return */ 
continue; 
} else < 
if (flag) 
{ 

irite(l,',M); /* if not first field, urrite a coffima */ 
} else ( 

flag =1; /* else it was first field, so toggle flag */ 
> 
} 

writeU,'\",i); /* write a field separator */ 
if(inbuffer[B3 == '\'M /* strip out apostrophe chars inserted by Profile */ 

ti!ritelnU,inbuffer+l,nc-2); /* write the line */ 
else 

writelnU , inbuffer, nc-1 ) ; 
write(l,'\'M); /* write a filed separator */ 

} /* and go around the loop */ 

free (inbuffer); /* free up ffiemory */ 



OOOOODOOOOOOOOOOOOOOODDDDOOOOO 



HARD DISK BAOdlPS 

We have in past editions comirtented on the uisdoffi 
of aaking regular backups of a hard disk. To 
quote one of our ffieffibers (D.E.) "there are two 
types of hard disk users; those who have just done 
a backup, and those who are about to have a 
crasnl' 



Now one can understand why 
little slack when it coaes 
the hard drive connected 
can often turn into a ir^jor 
several hours. This artic 
personal e);perience with 
hard disk utilities and whi 
an expert on the subject, 
useful. 



we probably all get a 

to making a backup of 

to the CoCo because it 

project which can take 

le is based on soise 

some of the available 

le I do not claisf to be 

I hope that you find it 



I run a 28 meg hard drive using the Eurke £• Burke 
interface and standard P.C. type controller. 
Burke £• Burke supply hard disk utilities with 
their XT interface which include 'hdb' &■ 'hdr' 
(hard disk backup fc hard disk restore). Also 
available separately is 'fsr', e hard disk file 



systePi repack utility which reads and rewrites 
files to eliminate fragmentation of the herd disk. 
These utilities work just fine, however the 
process can take many hours, 

HDKIT is another set of backup and restore 
utilities by Pete Lyall which is available from 
the public domain library. The description of the 
utilities directly froni the hdkit.doc file reads, 
'The suite of backup tools in this archive is a 
collection of programmes that are written, 
maintained, documented and updated by Pete Lyall. 
Some of them are based on early versions of 
similar tools written by Dan Connolly and those 
provided for a similar purpose in the Unix system 
(i.e. CPIO). This toolkit is SHAREWARE/ CHE APWARE. 
Please read the last paragraph of this file before 
going on,' (end quote) 

The tools include, Files, Archdir, Bigfile &• 
Restore. Hdkit uses pipes which tend to slow down 
its operation somewhat. 
Example :- 



files 



■bedge-3e 



archive /dd 
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provided for a siriiilar purpose in the Unix systeffi 
(i.e. CPIO). Tr.15 toolkit is SHAREWARE/CHEAPWARE. 
Please read the last paragraph of this file before 
going on,' (end quote) 

The tools include. Files, Archdir, Bigfile & 
Restore. Hdkit uses pipes which tend to slow dotim 
its operation somewhat. 

Exasiple s- 

files -bedge-30 ! archive /dd -vl 
/dd/log/monthly.log #40k ! bigfile /d0/part8 
/dl/partl /d2/part2 #40k 

The Hdkit suite works just fine, in fact I have 
used it for several backups and a couple of 
restores. 

The iiicst difficult part of using Hdkit is 
remeiTibering the correct syntax of coffiifiand 
modifiers and coirtniand lines. 

REEACK is a basic89 procedure written by Jeff 
Eloi^r which is a front end for Hdkit which ffiakes 
it »ena driven and retfieiBbers the coatifiand syntax 
for you. This procedure 1 have found to be very 
useful for backing up changed files or files 
created since the last backup. It saves a file 
" backup, date"* in the /dd/sys directory so that you 
don't even hays to remeffiber the date of the last 
backup. 



chd /h0 

files -ebdg-8! spanner 

l=/dd/log/friday.bkup 



/f0 



For info on peririanently changing 
other details, use 'irian spanner* 



/fl 



defaults and 



Personally, I find it most convenient to use 
"files" to create a backup. list which can be 
edited prior to running the backup. Here are the 
command lines and procedure which I use. 

files -etdgYY/«t1/DD >/r0/backup.Iist 

What this does is; 

E = expand to all directories 

T = total files and estimate disks needed for 

backup 

DG = dates of files greater than yy/mm/dd 

Now, edit the file "backup. list" to delete any 
files which are not to be included in the backup. 
0S9P<3ot £t ALTEoot are a couple which I normally 
delete as 1 use "boot port" to restore the kernels 
to the correct location on the disk along with 
0B9EcDt etc. 

Now to commence the backup; 

spanner /d3 /di -L=/r0/blc.g #32k </r0/baLkup. list 



SPANNER This is a utility written in C by Jay 
Heisse which also uses some of the tools from 
HDi-aT. 

SPAN»NER copies files (named on stdin) to removable 

media, 

-or- restores files/directories if -r option given 



In this evjafTfple, spanner will use floppy drive /d0 
for "parti" /dl for 'part2" and prompt for more 
media once the first two disks are filled. A log 
of all files archived will be created on /r0 
called "blog" (backup log). Spanner will read 
pathnafiies and files from "backup. list" and include 
only the files listed in this file. 



options: -r w -l[=lDgfilename] /devl /dev2 /dev3 
/dev4 

-r restores files from floppies to CURRENT 

directory 

-tf writes files to floppies, (default) 

-1 logfile, logs irtessages to /R8/blog by 

default. 

-1=FILENAM£ to change from default. 

/dev default backup drive is /Fl, but a drive or 

drives may be given. 

In the case of multiple drives, they will be used 

in E-equence before prompting for more media. 

Drivename arguments are recognized by the leading 

slash. 

example: 



The b-est part of all is the time saving. My hard 
drive has about 24,030 sectors in use by files, 
and Spanner does a full backup of all files in 
under one (i) hour, including floppy formatting. 
Spanner has a toggle which can be changed between 
floppies to turn ON & C>FF the floppy format 
function. 

To restore the file-s from the floppy backup set, 
just add the -r option (restore) 

spanner -r /d0 /dl -L=/r0/blDg #32k 

The above examples assume that device descriptor 
/dd refers to the hard drive, which will normally 
be the case. 

Gordon Eentzen. 
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DODOOOOOOOCK>(K)0000CK)OOOOODODDD 

The New 6Fy.2 

Those of you who read the magazine 'The Rainbou)\ would no doubt have seen the references to a 'new' 
GFX2 iBodule for use with Basic09. Indeed^ many were the curses heard by me when EasicBV programmes^ 
listed in that magazine, could not be used because a 'new version' was required. Well, now you can all 
use the new GFX2 module, because it is available from the software library. The copy we have in the 
library is a sort-of pre-release version, but all the necessary parts are there. The prograiTtnie archive is 
available in the usual way from our software librarian, Jean-Pierre Jacquet. 

I have taken one of the documentation files from the archive, and reproduced it here for you to whet 
your appetites, have a read of this:- 



WINDOW COMMANDS 



Previously, setting up menued windows, or even getting the iijouse packet, involved using the Syscall 
subroutine and information from the developer's docufsentaticn. 1 believe this has stymied the casual 
programiTfers a lot. In an attempt to make things easier, GFX2 now supports the more popular windowing stat 
calls. (See "gf>;2.Bian") 

There are four new calls used to set up a ffjenued window: TITLE, MENU, ITEM and WNSET. They require soffie 
prograiTi storage for the main window descriptor and each of the menus, which is most easily set up by 
defining string arrays. The main window descriptor variable must have a dimension of at least 2; 
otherwise the dimension should be at least the same count as the number of menu bar selections (across 
the top: like FILES, TANDY, etc), plus 1 more. 

Each menu bar selection may have items that are in its pulldown menu. Each pulldouln requires an array 
dimensioned to at least the number of items. 

SEHING UP MENUS 



!he new commands are much easier to use than to explain. In addition to the examples on disk and the 
Details here, let us set up a small menued window program as a quick example... 

Let's say that you wanted to write a program called 'Tools", that had two menu selections (in addition to 
the close box, which is automatically defined). These menus are called "Disk" and 'Memory". Under Disk we 
want 'Dir', 'Free', "PWD", and 'Format". Under Memory we want 'MFree' and 'Procs'. 

First, we must set aside storage for OS-9 and 5FX2. Since we have two menubar selections, we define a 
window descriptor arra'^ of size 2-^1 = 3. 

DIM wd(3):STRIN6 \ U This is the window descriptor) 

We also need to define storage for each pulldown menu. Our first selection has three items, our second 
has two. (NC>TE: if the number of items might change, simple give it more size accordingly). 

DIM ml(3):STRING \ (* Disk selection 
DIM m2(2):STRIN6 \ U MeiTtory selection 

We need to assign an ID number to both menu selections. Numbers 1-32 are reserved for the system, so 
let's use 33 and 34. 

DIM MId_Disk,MId.Mem:INTE6ER 

MId_Disk=33 

Mid Mem =34 
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We can also define some numbers that will make reading the program a little easier: 

DIM Di5able,Enable:INTEGER 

Di5able=0 

Enable=l 

The rest is easy! Simply fill in the blanks for the following coirmiands: Set the title name, minimum 
window size^ number of menu selections: 

RUN gf>:2CTitle%iiid, "Tools', 34, 10,2) 

Set up each menu selection position, name, ID,iijidth,itemcount, items, enable: 

RUN gf>;2Cf1enu",wd,l,"Di5kM1Id_Disk, 8,4, ml, Enable) 
RiJN gfx2('Item",ffll,l,'Dir ', Enable) 
RUN gf>^2CItem',ml,2,'Free ", Enable) 
RUN gf>;2('Item%ml,3,"PWD ', Enable) 
R*JN gfx2CItem", ml, 4, "Format", Disable) 

RUN gfx2('Menu",wd,2,"nemoryM1Id„Hem,5,2,m2,Enable) 
RUN gfx2(' Item", m2,l,"f1Fre&", Enable) 
RUN gf >:2('' Item", m2,2,^Procs', Enable) 

NOTE: the order isn't important atc-ve. It's Just easier to 'f5^6 this way. Nouj that ye have defined the 
lifindow, selections, and pulldauns, u^e can tell 0S9 to set u? a frauied (type=l) windoiii: 

RtJN gfx2rWnSet",l,u'd) 

You can disable or change the fiienus on the fly. 

USING THE flOUSE 



New that the menued bjindctyi is set up, there are ^^veral utility calls that are very helpful. First, life 
need to turn on the gfj< cursor and also the autofolloiL! (since wB'd ratUpr not keep telling 0S9 where to 
put the cursor! ). 

RUN gf>;2t"Setf1ouse',3,l,l) \ (* Turn on autcfolloii! 

RUN gf>'2(''GCSet%tCA,i) \ (* Use standard arrcAi pointer 

The House call will tell us the status of the pointing device: 

DIM valid,f ire, mx, my, area, s>;,sy: INTEGER \ i* Place at program front! 
RUN gf >i2 ( " Mouse" , va 1 i d, f i re, m>i , my , avEA^ sx , sy ) 

We could simple loop around, checking the mouse dT]6 the keyboard (INKEV), but quite often a program need 
only wait for the user to click his fire button, and only then do we go after the menu selection. This is 
much more friendly to other programs running, and aids in multitasking quite a bit: 

RUN gf>:2rOnMouse",0) \ (* Sleep until mouse clicked 

This will return only when this window is the interactive one, and the user has clicked his mouse button. 
Then we are woken up, and can figure out what he meant us to do: 



GETTING MENU SELECTIONS 
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On uiakeupi ue need to see if the user is really clicking on the menu area. 

RUN gf >;2 (' Mouse', validifi re, ni>[,f?(y, area, 5>;»5y) 

If valid isn't zero, and the right button is down, and the area is the menu areai then we know what the 
user Uieant. So we can call the Get Selection routine to let the user pulldown a menu or return a bar 
selection like Close. 

DIM fffenu_id, menu. it em: INTEGER \ (* This should be at front of program! 
RUN gf>:2("GetSer,rfenu_id,ntenu_ite{Ti 

The menu.id will be the wenubar selection (00 if none), and the menu.iteffi will be the specific pulldown 
item number. 

The total loop to wait for a click, see if menu, get the selection, is: 

LOOP 
RUN gfx2COnHouseS0) 

RUN gf>;2( "Mouse" , val i d, f ire, fffXjirty , area, sx , sy ) 
IF validOe AND fire=l AND area=l THEN 
RUN gfx2("GetSer,Fr{enu_id,i!(enu_iteiri) 
IF menu_id <> THEN 
50SUE >;xx \ (* go do selection nupsber *) 
ENDIF 
ENDIF 
ENDLOOP 

You could also wait for the mouse click in a dratijing progra?!!. for example, and if it wasn't on the 
menubar area (area=l) then you could start a drawing loop or whatever. 

For those of you who write programmes in Ea5ic09, this will really take the work out of using the 
Multi-Vue windowing manager, with its pulldowns and mouse selection. I expect to see a flood of requests 
for usergroup software after this. 

Bob Devries. 

OOCSDOODDGOOOiXlOOOOOoOOOOODOOOO 

STARTING miTU^ 



Most, if not all of CoCo OS? Level 2 users 
occasionally use the Multi-Vue desktop graphical 
interface on their machines. With the patches 
which are available for gsheli, it fr^akes a 
reasonably good GUI (Graphical User Interface) 
which runs at an acceptable speed. All of the 
patches for speed and operational improvement are 
available from our Public Domain Library. 

One of the things that has irked me for some time, 
was the fact that fftultistart really does not leave 
your system in the state in which it existed, 
before Multi-Vue was run. The main problem 
involves the replacement on an existing window 
with a graphics window. If you are like me, you 
only use graphics windows when you absolutely have 
to, and to have one of your existing windows 
changed to a hi-res graphics window, often with 



proportionally spaced hi-res fonts in operation, 
is not acceptable. 

To get around this problem, I wrote the following 
utility to replace MultiStart. Source code for 
both C and Easic89 versions are included for you. 
The utility is simply named mvu, and uses the 
system default settings to start multiview. (ie 
Mouse Resolution end Port, as well as colours 
initially selected.) Changes to these settings 
could be fairly simply added to the code, however 
I will leave that to you to do. Something to keep 
you occupied over the Christmas holidays, (grin). 

The only other thing to look out for (see comments 
in sources) is the setting of the execution 
directory. You will Uav^ to change this to 
reflect your own system setup. In other words. 
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the location of your MultiVue coffimands needs to be 

set in that particular line, or the prograiriirie will Cheers ... Don Berrie. 

not tuork. 



C Source Code 

/* Mvu.c -- simple Multistart replacement — (c) 1990 D. Berrie */ 

#include Vh0/usr/ccomp/defs/stdio.h" 
^include " /h0/usr/ccofffp/def 5/os9. h' 

int wpath; 

struct registers regs; 

mainO 
( 

char devnafii[32j; 
char systr[53]; 
int *fT(VPrnoi 
systr[8] = 'W; 
iupath=oper!('/!ij"»3); 
DWSetdi'path, 7,0,0,30,24, 0,0,0); 
ge tdev ( devnarrj, iispat h ) ; 

ch>;dir(*/h0/r[iid5/>tC!Tfds'); /***** Change for your oyn system ^^^**/ 
Select (wpath); 

strcpyisystr, "gshell <>»' ) ; 
strcat(sy5tr,deynam); 
systefT((systr); 
} 

getdey(out5tr,p3thno) 
char outstr[32]; 
int pathno; 

( 

char teiijstr[32]; 

char *ptr: 

int 1 = 3: 

outstr[0] = '/'] 

outstr[l] = 'W, 

ptr = ter^str; 

regs.rg_a = pathno? 

regs.rg_b = 0>:8e; 

regs.rg.x = ptr? 

_os9(LGETSTT,£regs}; 

for (1=0; teffiStrCi] < 0>;7d M- temstrfil > 0;i++); 

t8mstr[i] = temstr[i] ^ 8>;7f; 

temstr[i+n = ^\s^; 

strcat i ou tstr , temstr ) ; 



BASICB9 Source Cdcte 

PROCEDURE fflvu 

(* Mvu -- Simple Hultistart replacement — (c) 1990 D. Berrie *) 
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DIM devnaiT.:STRINGC32] 

DIM 5y5tr:STRIN6[50] 

DIM wpath:BYTE 

OPEN #wpath,Vw":UPDATE 

RUN gf>:2(ti}path,"dut5et",?,0,0,80,24,0,0,0] 

RUN getdev(devnam,utpath) 

CHX Vh0/cmd5/>;cffid5' (***** Change for your otun systeirt *****) 

RUN gf>:2(utpath, "select" ) 

SHELL "gshell <»>"+devnam 



PROCEDURE getdev 

ON ERROR GOTO 

TYPE regi5ter5=cc,a,b,dp:BYTE; x,y,u:lNTEGER 

DIM regsiregisters 

PARAM devTiam:STRING[32] 

PARAM wpathrBYTE 

DIM i: INTEGER 

DIM call code: BYTE 

DIM errnu.Ty:BYTE 

reg5.a=wpath 

reg5.b=$^ 

regs , >i=ADDR ( devnaiTi ) 

callcode=$8D 

RIJN syscd 1 i i ca i 1 code » r egs ) 

FOR i=l TO 32 

EXITIF MID$(devnain,iil)>CHR$(i29) THEN 

devnaBi="/"+LEFTt(devnam,i-t)+CHR$(ASC<MID$(devnaii.,iil))-12S) 

ENDEXIT 

NEXT i 

END 

1000 WM clQserTddpath.errnuin) 

END 



ocoogocqodOOOOOOOOOOgooogodgod 
DATAfiOIHLES 



Do you have a floppy disk system? Hou) sany ti fries 
have you typed the line: 

chd /d8;chx /d0/ciRds 

If you are like sei that is about the only line 
that you can touch-type!! Before I purchased Fiy 
hard diski I suppose I typed just that line isaybe 
20 or 30 tijK each session!! You know, every tirrte 
that you wanted to run 50.7jething different, ar)G 
you did not have the correct disk in your 
(single?) drive^you needed to type this string, 

OK so now you've spent your dollars, and puchased 
a hard drive. Now the probleffi becomes: 

chd /h8/usr/ved/±<cs;ch>; /h0/u5r/ved/cmds 

This is really no better!! 

Well an answer is at hand. Using packed data 



Triodules, uje c^n siJBply replace these strings with 
a (perhaps) tuio or saybe three letter coirmiand. 
\^rB is the process. 

First of all build your string, using a text 
editor or whatever, iriaybe you could even use edit. 
Just a siffiple exa-^pie at first. 

EDIT neaid (for newdisk) 

chd /d0;chx /dS/cfflds 

q(uit) 

Then, using dataifiod (available frcpi our PD 
library) pack the siodule. 

DATANOD nd <neiud >rfd 

ATTR nd e pe 
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LDAD nd and replace the cisk. Vgu will then be located 

back ttnere ycu caf^e trcui. 

Now when ycu type nd, the corjoand string "chr 

/dO;ch^; /dO/ciDds" and then the executable fjle As you can see, the possibilities are endless!!! 

Hill be executed'!' Neat hey? 

One further enhancefnent, each of these packefj 

Another variation would be to use e^iactly the data isodules are siarefnely 5;:iall Ui te^ns or the 

same string, but enclose it in brackets. That nuT3t" c" bytts ot fiie:Hory used), and so a large 

15, "(rhd /cO;chx /dO/ciPG5)\ 5g ihrnaQj t^e nuf^ter of tneai can be craniiiied into one BK block 

sar^e p'ccess again, this tirns gi^-'inq it a :y inerging theiif togsthe^ before they are leaded. 

different p.&^^e, say nsd, and not usng 3 Vdu raay even nave enough space left with your 

particular executable file to ran. Then when yau modules ine^'qed vath SHcLL to fit in a few. That 

load and execute the coiES\and, "nsd", the syste?!; way, you. qe: ail o- tne advantages, and ataybe use 

villi start a new shell, in the current Kinaori, NG siefnory'! 

and proceed to change the directories. Then you 

can rau any process frofli that shell that you Happy Christaas ... uon Berrie. 

Kish. i^hen you have finisned witn that 

particular disk, sisiply type (COfJTROL) + <BREAK> 



CDGOOGDGOOOCOOQDOGOOOCGGOOOCOD 
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The COCO-LINK AVARO is presented annually to individuals 
or organisations who the editors of COCO-LINK consider 
have contributed something of value to the Coco CoBinunity 
in Australia. $100.00 is awarded each year. 

This year's COCO-LINK AVARD goes to the NATIONAL 0S9 USER 
GROUP for organising and maintaining this very inportant 
section of the Australian Coco world. 

I think we all owe a debt of gratitude to Gordon Bentzen, 
Bob Oevries and Don Berrie for taking up the challenge 
and bringing new life to the 0S9 User Group after it had 
fallen by the wayside. These three gentlemen deserve all 
the accolades we can bestow on then. 



which is available to subscribers at siinisial cost. The 

three office holders naned above have always been found 

willing to help straighten out the problems of the less 
informed. 

In presenting the $100.00 cheque to the NATIONAL 0S9 USER 
GROUP we hope, in some small way, to help ease the 
financial burdon of running a national group such as this 
and, in so doing, insure the continuance of the group. 

l^e heartily congratulate you on a job well done. 

Robbie Oalzell i Garry Holder 
For COCO-LINK Magazine. 



The monthly newsletter of the National OSS User group (Details on how to subscribe to the NATIONAL 0S9 USER 

carries information and programming for the budding, as GROUP can be found in the Noticeboard page in this 

well as the more advanced OSS user. The Group also magazine), 
maintains a large library of 0S9 Public Domain software 
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